package com.eduagent.xwqeduagent.api.SpeechEvaluation;

import java.io.IOException;

/**
 * 语音评测服务接口
 */
public interface SpeechEvaluationService {

    /**
     * 开始语音评测
     * 
     * @param params 评测参数
     * @param audioData 音频数据
     * @return 评测结果
     * @throws Exception 评测异常
     */
    String evaluate(SpeechEvaluationParams params, byte[] audioData) throws Exception;

    /**
     * 开始语音评测（从文件）
     * 
     * @param params 评测参数
     * @param audioFilePath 音频文件路径
     * @return 评测结果
     * @throws Exception 评测异常
     */
    String evaluateFromFile(SpeechEvaluationParams params, String audioFilePath) throws Exception;
} 